/**
 * 俱乐部活动响应视图对象
 * 用于封装俱乐部活动的相关信息，提供给前端界面展示
 */
package org.club.common.model.vo;

import lombok.Data;
import java.util.List;

/**
 * 俱乐部活动响应视图对象
 * 该类包含了俱乐部活动的总数、平均活动分数、最大活动分数以及具体的活动列表和活动趋势数据
 * 主要解决如何将俱乐部活动的统计数据和详细信息一并返回给前端的问题
 */
@Data
public class ClubActivityResponseVO {
    /**
     * 俱乐部活动总数
     * 用于记录查询到的俱乐部活动总数量
     */
    private Integer totalActivity;

    /**
     * 俱乐部活动平均分数
     * 用于记录所有俱乐部活动的平均分数，以便于分析活动的总体情况
     */
    private Double averageActivity;

    /**
     * 最大活动分数
     * 记录所有活动中最高的分数，用于识别最热门或最受欢迎的活动
     */
    private Integer maxActivity;

    /**
     * 俱乐部活动列表
     * 包含了具体的俱乐部活动详情，每个活动都是一个ClubActivityVO对象
     */
    private List<ClubActivityVO> clubActivityList;

    /**
     * 活动趋势数据
     * 记录了一段时间内俱乐部活动的变化趋势，用于分析活动的动态变化
     */
    private List<ClubActivityTrendVO> trendData;
}
